SET

man2html: unable to open or read file /usr/lib/ms/ms.acc

NAME

SYNOPSIS

#include "<SOS>/include/agg_sos.h"

class Set<Entity> (sos_Bool list_cursor = TRUE,
                   sos_Bool based_on_equal = FALSE)
   : Collection<Entity> (based_on_equal)
{
public:
   void         insert     (Entity);
   void         remove     (Entity);
   void         operator+= (Set<Entity>);
   void         operator-= (Set<Entity>);
   void         operator*= (Set<Entity>);
   sos_Bool     operator<  (Set<Entity>);
   sos_Bool     operator<= (Set<Entity>);
   sos_Bool     operator>  (Set<Entity>);
   sos_Bool     operator>= (Set<Entity>);
}

DESCRIPTION

The class Set<Entity> provides means for manipulating generic sets. The type of the elements of a Set is stated when the Set type is instantiated (Methods that overwrite inherited methods are only described in the superclass, where they are inherited from - provided that they are semantically equivalent).

Set::create (ct, list_cursor, based_on_equal)

The create parameter based_on_equal determines if tests for membership in the Set should be based on the equality or identity of the respective entities, as in superclass Collection. The additional parameter list_cursor decides, whether the Set may dynamically be modified while a cursor iterates over the structure. If list_cursor == FALSE, and modifying operations are performed on a Set during a scan with an sos_Cursor, the behavior of sos_Cursor operations after the modification is undefined. On the other hand, a Set that is created with list_cursor == TRUE will require a bit more of persistent memory.

insert (e)

inserts entity e.

remove (e)

removes entity e from self.

operator+= (s)

performs a union with Set s.

operator-= (s)

subtracts Set b from self.

operator*= (s)

intersects Set s with self.

operator< (s)

returns TRUE if self is a subset of Set s, FALSE otherwise.

operator<= (s)

returns TRUE if self is a subset of Set s or if self is equal to Set s, FALSE otherwise.

operator> (s)

returns TRUE if self is a superset of Set s, FALSE otherwise.

operator>= (s)

returns TRUE if self is a superset of Set s or if self is equal to Set s, FALSE otherwise.

FILES

<SOS>/src/agg/agg.sos

SOS schema file

<SOS>/src/agg/agg_sos.h

complete schema interface

<SOS>/src/agg/agg_use.h

restricted schema interface

<SOS>/src/agg/agg_ext.h

definition of iterators (automatically included by agg_use.h)

<SOS>/src/agg/Set.c

Set implementation file

<SOS>/lib/sos.a

SOS library

SEE_ALSO

sos_Object(3), sos_Aggregate(3), Collection(3), sos_Cursor(3)  

AUTHOR

Bernhard Schiefer, Dietmar Theobald

Index

NAME

SYNOPSIS

DESCRIPTION

FILES

SEE_ALSO

AUTHOR